Skip to content

fix(npm): preserve explicit setup versions - #465

Merged
morluto merged 4 commits into
mainfrom
agent/refresh-stale-npx-bootstrap
Aug 9, 2026
Merged

fix(npm): preserve explicit setup versions#465
morluto merged 4 commits into
mainfrom
agent/refresh-stale-npx-bootstrap

Conversation

@morluto

@morluto morluto commented Aug 6, 2026

Copy link
Copy Markdown
Owner

Description

npm consumes a positional package spec before launching the selected binary. Once REA starts, npx rea-agents setup and npx rea-agents@2.4.0 setup can therefore expose the same arguments and environment. The dispatcher cannot safely refresh one without risking replacement of an intentional exact-version request.

This change removes that ambiguous hidden self-relaunch. Each README keeps one low-friction npx rea-agents setup first-run entrypoint. Repeated quick-start, agent setup, terminal/no-install, and post-install paths explicitly request current online metadata with npx --yes --prefer-online rea-agents@latest setup. REA always runs the version npm selected.

The obsolete bootstrap helper, declaration, package entry, and implementation-shaped tests are removed. Documentation conformance now guards both the simple first-run entrypoint and the explicit freshness/rollback contract.

Intentional rollbacks remain available through:

npm exec --yes --package=rea-agents@2.4.0 -- rea setup

Type of Change

  • Bug fix
  • Documentation update
  • Refactoring
  • Tool contract change (MCP schema modification)

Testing Performed

  • npm exec -- vitest run tests/boundary/cli/dispatcher.test.ts tests/conformance/readmeConsistency.test.ts (10 tests passed)
  • npm run check:fast
  • npm run docs:check
  • npm pack --dry-run --json (dispatcher present; removed bootstrap absent)
  • npm run verify:package built and packed successfully, then stopped in the unrelated Linux Hopper platform check because Xvfb is unavailable on the local host

Tool Contract Impact

None. MCP tools and schemas are unchanged.

@morluto
morluto marked this pull request as ready for review August 6, 2026 15:50
@cursor

cursor Bot commented Aug 6, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 78f39483b6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/package-runner-bootstrap.mjs Outdated
@morluto morluto changed the title fix(npm): refresh stale npx setup bootstraps fix(npm): preserve explicit setup versions Aug 9, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ed000e1459

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread README.md Outdated
@morluto
morluto merged commit 1783bf6 into main Aug 9, 2026
18 checks passed
@morluto
morluto deleted the agent/refresh-stale-npx-bootstrap branch August 9, 2026 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant